/**
 * Swagger 注释要素模板（基于OpenAPI 3.0规范）
 * 
 * @swagger
 * /endpoint:
 *   http_method:
 *     tags:              # 接口分类（数组）
 *       - category1
 *     summary: ''        # 接口简要描述（50字内）
 *     description: ''    # 接口详细描述（可换行）
 *     
 *     parameters:        # 请求参数定义
 *       - in: path       # 参数位置（path/query/header/cookie）
 *         name: paramName
 *         required: true # 是否必填
 *         schema:
 *           type: string # 参数类型（string/number/boolean/integer/array）
 *         description: ''# 参数说明
 *         example: ''    # 参数示例值（可选）
 * 
 *     requestBody:       # 请求体参数（POST/PUT/PATCH）
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             type: object
 *             properties:
 *               field1:
 *                 type: integer
 *                 format: int64  # 格式限定（int32/date-time/email等）
 *                 description: ''
 *             required:          # 必填字段列表
 *               - field1
 * 
 *     responses:
 *       '200':
 *         description: ''        # 响应描述
 *         content:
 *           application/json:
 *             schema:
 *               type: object     # 响应数据结构
 *               properties:
 *                 code:
 *                   type: integer
 *                   enum: [0,1]  # 枚举值约束
 *                 data:          # 复杂类型示例
 *                   type: array
 *                   items:
 *                     $ref: '#/components/schemas/DataModel'
 *                 message:
 *                   type: string
 * 
 * components:
 *   schemas:            # 数据模型定义区
 *     DataModel:
 *       type: object
 *       properties:
 *         id:
 *           type: string
 *           format: uuid
 *         timestamp:
 *           type: string
 *           format: date-time
 */

// 分页参数通用模板（可直接复制）
// parameters:
//   - in: query
//     name: page
//     schema: { type: number }
//     description: 当前页码
//   - in: query
//     name: pageSize
//     schema: { type: number }
//     description: 每页数据量